<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>open_framegrabber [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_image.html">Image</a> / <a href="toc_image_acquisition.html">Acquisition</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">open_framegrabber</span><span data-if="c" style="display:none;">T_open_framegrabber</span><span data-if="cpp" style="display:none;">OpenFramegrabber</span><span data-if="dotnet" style="display:none;">OpenFramegrabber</span><span data-if="python" style="display:none;">open_framegrabber</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">open_framegrabber</span><span data-if="c" style="display:none;">T_open_framegrabber</span><span data-if="cpp" style="display:none;">OpenFramegrabber</span><span data-if="dotnet" style="display:none;">OpenFramegrabber</span><span data-if="python" style="display:none;">open_framegrabber</span></code> — Open and configure an image acquisition device.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>open_framegrabber</b>( :  : <a href="#Name"><i>Name</i></a>, <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, <a href="#VerticalResolution"><i>VerticalResolution</i></a>, <a href="#ImageWidth"><i>ImageWidth</i></a>, <a href="#ImageHeight"><i>ImageHeight</i></a>, <a href="#StartRow"><i>StartRow</i></a>, <a href="#StartColumn"><i>StartColumn</i></a>, <a href="#Field"><i>Field</i></a>, <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, <a href="#ColorSpace"><i>ColorSpace</i></a>, <a href="#Generic"><i>Generic</i></a>, <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, <a href="#CameraType"><i>CameraType</i></a>, <a href="#Device"><i>Device</i></a>, <a href="#Port"><i>Port</i></a>, <a href="#LineIn"><i>LineIn</i></a> : <a href="#AcqHandle"><i>AcqHandle</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_open_framegrabber</b>(const Htuple <a href="#Name"><i>Name</i></a>, const Htuple <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, const Htuple <a href="#VerticalResolution"><i>VerticalResolution</i></a>, const Htuple <a href="#ImageWidth"><i>ImageWidth</i></a>, const Htuple <a href="#ImageHeight"><i>ImageHeight</i></a>, const Htuple <a href="#StartRow"><i>StartRow</i></a>, const Htuple <a href="#StartColumn"><i>StartColumn</i></a>, const Htuple <a href="#Field"><i>Field</i></a>, const Htuple <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const Htuple <a href="#ColorSpace"><i>ColorSpace</i></a>, const Htuple <a href="#Generic"><i>Generic</i></a>, const Htuple <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const Htuple <a href="#CameraType"><i>CameraType</i></a>, const Htuple <a href="#Device"><i>Device</i></a>, const Htuple <a href="#Port"><i>Port</i></a>, const Htuple <a href="#LineIn"><i>LineIn</i></a>, Htuple* <a href="#AcqHandle"><i>AcqHandle</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>OpenFramegrabber</b>(const HTuple&amp; <a href="#Name"><i>Name</i></a>, const HTuple&amp; <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, const HTuple&amp; <a href="#VerticalResolution"><i>VerticalResolution</i></a>, const HTuple&amp; <a href="#ImageWidth"><i>ImageWidth</i></a>, const HTuple&amp; <a href="#ImageHeight"><i>ImageHeight</i></a>, const HTuple&amp; <a href="#StartRow"><i>StartRow</i></a>, const HTuple&amp; <a href="#StartColumn"><i>StartColumn</i></a>, const HTuple&amp; <a href="#Field"><i>Field</i></a>, const HTuple&amp; <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const HTuple&amp; <a href="#ColorSpace"><i>ColorSpace</i></a>, const HTuple&amp; <a href="#Generic"><i>Generic</i></a>, const HTuple&amp; <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const HTuple&amp; <a href="#CameraType"><i>CameraType</i></a>, const HTuple&amp; <a href="#Device"><i>Device</i></a>, const HTuple&amp; <a href="#Port"><i>Port</i></a>, const HTuple&amp; <a href="#LineIn"><i>LineIn</i></a>, HTuple* <a href="#AcqHandle"><i>AcqHandle</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>HFramegrabber</b>(const HString&amp; <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const HString&amp; <a href="#Field"><i>Field</i></a>, const HTuple&amp; <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const HTuple&amp; <a href="#ColorSpace"><i>ColorSpace</i></a>, const HTuple&amp; <a href="#Generic"><i>Generic</i></a>, const HString&amp; <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const HTuple&amp; <a href="#CameraType"><i>CameraType</i></a>, const HTuple&amp; <a href="#Device"><i>Device</i></a>, const HTuple&amp; <a href="#Port"><i>Port</i></a>, const HTuple&amp; <a href="#LineIn"><i>LineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>HFramegrabber</b>(const HString&amp; <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const HString&amp; <a href="#Field"><i>Field</i></a>, Hlong <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const HString&amp; <a href="#ColorSpace"><i>ColorSpace</i></a>, double <a href="#Generic"><i>Generic</i></a>, const HString&amp; <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const HString&amp; <a href="#CameraType"><i>CameraType</i></a>, const HString&amp; <a href="#Device"><i>Device</i></a>, Hlong <a href="#Port"><i>Port</i></a>, Hlong <a href="#LineIn"><i>LineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>HFramegrabber</b>(const char* <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const char* <a href="#Field"><i>Field</i></a>, Hlong <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const char* <a href="#ColorSpace"><i>ColorSpace</i></a>, double <a href="#Generic"><i>Generic</i></a>, const char* <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const char* <a href="#CameraType"><i>CameraType</i></a>, const char* <a href="#Device"><i>Device</i></a>, Hlong <a href="#Port"><i>Port</i></a>, Hlong <a href="#LineIn"><i>LineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>HFramegrabber</b>(const wchar_t* <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const wchar_t* <a href="#Field"><i>Field</i></a>, Hlong <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const wchar_t* <a href="#ColorSpace"><i>ColorSpace</i></a>, double <a href="#Generic"><i>Generic</i></a>, const wchar_t* <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const wchar_t* <a href="#CameraType"><i>CameraType</i></a>, const wchar_t* <a href="#Device"><i>Device</i></a>, Hlong <a href="#Port"><i>Port</i></a>, Hlong <a href="#LineIn"><i>LineIn</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>OpenFramegrabber</b>(const HString&amp; <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const HString&amp; <a href="#Field"><i>Field</i></a>, const HTuple&amp; <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const HTuple&amp; <a href="#ColorSpace"><i>ColorSpace</i></a>, const HTuple&amp; <a href="#Generic"><i>Generic</i></a>, const HString&amp; <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const HTuple&amp; <a href="#CameraType"><i>CameraType</i></a>, const HTuple&amp; <a href="#Device"><i>Device</i></a>, const HTuple&amp; <a href="#Port"><i>Port</i></a>, const HTuple&amp; <a href="#LineIn"><i>LineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>OpenFramegrabber</b>(const HString&amp; <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const HString&amp; <a href="#Field"><i>Field</i></a>, Hlong <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const HString&amp; <a href="#ColorSpace"><i>ColorSpace</i></a>, double <a href="#Generic"><i>Generic</i></a>, const HString&amp; <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const HString&amp; <a href="#CameraType"><i>CameraType</i></a>, const HString&amp; <a href="#Device"><i>Device</i></a>, Hlong <a href="#Port"><i>Port</i></a>, Hlong <a href="#LineIn"><i>LineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>OpenFramegrabber</b>(const char* <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const char* <a href="#Field"><i>Field</i></a>, Hlong <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const char* <a href="#ColorSpace"><i>ColorSpace</i></a>, double <a href="#Generic"><i>Generic</i></a>, const char* <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const char* <a href="#CameraType"><i>CameraType</i></a>, const char* <a href="#Device"><i>Device</i></a>, Hlong <a href="#Port"><i>Port</i></a>, Hlong <a href="#LineIn"><i>LineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>::<b>OpenFramegrabber</b>(const wchar_t* <a href="#Name"><i>Name</i></a>, Hlong <a href="#HorizontalResolution"><i>HorizontalResolution</i></a>, Hlong <a href="#VerticalResolution"><i>VerticalResolution</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const wchar_t* <a href="#Field"><i>Field</i></a>, Hlong <a href="#BitsPerChannel"><i>BitsPerChannel</i></a>, const wchar_t* <a href="#ColorSpace"><i>ColorSpace</i></a>, double <a href="#Generic"><i>Generic</i></a>, const wchar_t* <a href="#ExternalTrigger"><i>ExternalTrigger</i></a>, const wchar_t* <a href="#CameraType"><i>CameraType</i></a>, const wchar_t* <a href="#Device"><i>Device</i></a>, Hlong <a href="#Port"><i>Port</i></a>, Hlong <a href="#LineIn"><i>LineIn</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>OpenFramegrabber</b>(<a href="HTuple.html">HTuple</a> <a href="#Name"><i>name</i></a>, <a href="HTuple.html">HTuple</a> <a href="#HorizontalResolution"><i>horizontalResolution</i></a>, <a href="HTuple.html">HTuple</a> <a href="#VerticalResolution"><i>verticalResolution</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ImageWidth"><i>imageWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ImageHeight"><i>imageHeight</i></a>, <a href="HTuple.html">HTuple</a> <a href="#StartRow"><i>startRow</i></a>, <a href="HTuple.html">HTuple</a> <a href="#StartColumn"><i>startColumn</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Field"><i>field</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BitsPerChannel"><i>bitsPerChannel</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ColorSpace"><i>colorSpace</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Generic"><i>generic</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ExternalTrigger"><i>externalTrigger</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CameraType"><i>cameraType</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Device"><i>device</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Port"><i>port</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LineIn"><i>lineIn</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#AcqHandle"><i>acqHandle</i></a>)</code></p>
<p>
<code>public <a href="HFramegrabber.html">HFramegrabber</a>(string <a href="#Name"><i>name</i></a>, int <a href="#HorizontalResolution"><i>horizontalResolution</i></a>, int <a href="#VerticalResolution"><i>verticalResolution</i></a>, int <a href="#ImageWidth"><i>imageWidth</i></a>, int <a href="#ImageHeight"><i>imageHeight</i></a>, int <a href="#StartRow"><i>startRow</i></a>, int <a href="#StartColumn"><i>startColumn</i></a>, string <a href="#Field"><i>field</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BitsPerChannel"><i>bitsPerChannel</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ColorSpace"><i>colorSpace</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Generic"><i>generic</i></a>, string <a href="#ExternalTrigger"><i>externalTrigger</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CameraType"><i>cameraType</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Device"><i>device</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Port"><i>port</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LineIn"><i>lineIn</i></a>)</code></p>
<p>
<code>public <a href="HFramegrabber.html">HFramegrabber</a>(string <a href="#Name"><i>name</i></a>, int <a href="#HorizontalResolution"><i>horizontalResolution</i></a>, int <a href="#VerticalResolution"><i>verticalResolution</i></a>, int <a href="#ImageWidth"><i>imageWidth</i></a>, int <a href="#ImageHeight"><i>imageHeight</i></a>, int <a href="#StartRow"><i>startRow</i></a>, int <a href="#StartColumn"><i>startColumn</i></a>, string <a href="#Field"><i>field</i></a>, int <a href="#BitsPerChannel"><i>bitsPerChannel</i></a>, string <a href="#ColorSpace"><i>colorSpace</i></a>, double <a href="#Generic"><i>generic</i></a>, string <a href="#ExternalTrigger"><i>externalTrigger</i></a>, string <a href="#CameraType"><i>cameraType</i></a>, string <a href="#Device"><i>device</i></a>, int <a href="#Port"><i>port</i></a>, int <a href="#LineIn"><i>lineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>.<b>OpenFramegrabber</b>(string <a href="#Name"><i>name</i></a>, int <a href="#HorizontalResolution"><i>horizontalResolution</i></a>, int <a href="#VerticalResolution"><i>verticalResolution</i></a>, int <a href="#ImageWidth"><i>imageWidth</i></a>, int <a href="#ImageHeight"><i>imageHeight</i></a>, int <a href="#StartRow"><i>startRow</i></a>, int <a href="#StartColumn"><i>startColumn</i></a>, string <a href="#Field"><i>field</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BitsPerChannel"><i>bitsPerChannel</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ColorSpace"><i>colorSpace</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Generic"><i>generic</i></a>, string <a href="#ExternalTrigger"><i>externalTrigger</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CameraType"><i>cameraType</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Device"><i>device</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Port"><i>port</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LineIn"><i>lineIn</i></a>)</code></p>
<p>
<code>void <a href="HFramegrabber.html">HFramegrabber</a>.<b>OpenFramegrabber</b>(string <a href="#Name"><i>name</i></a>, int <a href="#HorizontalResolution"><i>horizontalResolution</i></a>, int <a href="#VerticalResolution"><i>verticalResolution</i></a>, int <a href="#ImageWidth"><i>imageWidth</i></a>, int <a href="#ImageHeight"><i>imageHeight</i></a>, int <a href="#StartRow"><i>startRow</i></a>, int <a href="#StartColumn"><i>startColumn</i></a>, string <a href="#Field"><i>field</i></a>, int <a href="#BitsPerChannel"><i>bitsPerChannel</i></a>, string <a href="#ColorSpace"><i>colorSpace</i></a>, double <a href="#Generic"><i>generic</i></a>, string <a href="#ExternalTrigger"><i>externalTrigger</i></a>, string <a href="#CameraType"><i>cameraType</i></a>, string <a href="#Device"><i>device</i></a>, int <a href="#Port"><i>port</i></a>, int <a href="#LineIn"><i>lineIn</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>open_framegrabber</b>(<a href="#Name"><i>name</i></a>: str, <a href="#HorizontalResolution"><i>horizontal_resolution</i></a>: int, <a href="#VerticalResolution"><i>vertical_resolution</i></a>: int, <a href="#ImageWidth"><i>image_width</i></a>: int, <a href="#ImageHeight"><i>image_height</i></a>: int, <a href="#StartRow"><i>start_row</i></a>: int, <a href="#StartColumn"><i>start_column</i></a>: int, <a href="#Field"><i>field</i></a>: str, <a href="#BitsPerChannel"><i>bits_per_channel</i></a>: MaybeSequence[int], <a href="#ColorSpace"><i>color_space</i></a>: MaybeSequence[str], <a href="#Generic"><i>generic</i></a>: MaybeSequence[Union[str, float, int]], <a href="#ExternalTrigger"><i>external_trigger</i></a>: str, <a href="#CameraType"><i>camera_type</i></a>: MaybeSequence[str], <a href="#Device"><i>device</i></a>: MaybeSequence[str], <a href="#Port"><i>port</i></a>: MaybeSequence[int], <a href="#LineIn"><i>line_in</i></a>: MaybeSequence[int]) -&gt; HHandle</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">open_framegrabber</span><span data-if="c" style="display:none">open_framegrabber</span><span data-if="cpp" style="display:none">OpenFramegrabber</span><span data-if="com" style="display:none">OpenFramegrabber</span><span data-if="dotnet" style="display:none">OpenFramegrabber</span><span data-if="python" style="display:none">open_framegrabber</span></code> opens and configures the
chosen image acquisition device.  During this process, the connection to
the image acquisition device is tested, the image acquisition device is
locked for other processes, and, if necessary, memory is
reserved for the data buffers. The actual image grabbing is done via the
operators <a href="grab_image.html"><code><span data-if="hdevelop" style="display:inline">grab_image</span><span data-if="c" style="display:none">grab_image</span><span data-if="cpp" style="display:none">GrabImage</span><span data-if="com" style="display:none">GrabImage</span><span data-if="dotnet" style="display:none">GrabImage</span><span data-if="python" style="display:none">grab_image</span></code></a>, <a href="grab_data.html"><code><span data-if="hdevelop" style="display:inline">grab_data</span><span data-if="c" style="display:none">grab_data</span><span data-if="cpp" style="display:none">GrabData</span><span data-if="com" style="display:none">GrabData</span><span data-if="dotnet" style="display:none">GrabData</span><span data-if="python" style="display:none">grab_data</span></code></a>, <a href="grab_image_async.html"><code><span data-if="hdevelop" style="display:inline">grab_image_async</span><span data-if="c" style="display:none">grab_image_async</span><span data-if="cpp" style="display:none">GrabImageAsync</span><span data-if="com" style="display:none">GrabImageAsync</span><span data-if="dotnet" style="display:none">GrabImageAsync</span><span data-if="python" style="display:none">grab_image_async</span></code></a>,
or <a href="grab_data_async.html"><code><span data-if="hdevelop" style="display:inline">grab_data_async</span><span data-if="c" style="display:none">grab_data_async</span><span data-if="cpp" style="display:none">GrabDataAsync</span><span data-if="com" style="display:none">GrabDataAsync</span><span data-if="dotnet" style="display:none">GrabDataAsync</span><span data-if="python" style="display:none">grab_data_async</span></code></a>. If the image acquisition device is not needed
anymore, it should be closed via 该算子 <a href="close_framegrabber.html"><code><span data-if="hdevelop" style="display:inline">close_framegrabber</span><span data-if="c" style="display:none">close_framegrabber</span><span data-if="cpp" style="display:none">CloseFramegrabber</span><span data-if="com" style="display:none">CloseFramegrabber</span><span data-if="dotnet" style="display:none">CloseFramegrabber</span><span data-if="python" style="display:none">close_framegrabber</span></code></a>,
releasing it for other processes. Some image acquisition devices allow
to open several instances of the same image acquisition device class.
</p>
<p>For all parameters image acquisition device-specific default values can
be chosen explicitly (see the parameter description below). Additional
information for a specific image acquisition device is available via
<a href="info_framegrabber.html"><code><span data-if="hdevelop" style="display:inline">info_framegrabber</span><span data-if="c" style="display:none">info_framegrabber</span><span data-if="cpp" style="display:none">InfoFramegrabber</span><span data-if="com" style="display:none">InfoFramegrabber</span><span data-if="dotnet" style="display:none">InfoFramegrabber</span><span data-if="python" style="display:none">info_framegrabber</span></code></a>. A comprehensive documentation of all
image acquisition device-specific parameters can be found in the
corresponding interface documentation in the directory
<code>doc/html/reference/acquisition</code>.
</p>
<p>The meaning of the particular parameters is as follows:
</p>
<dl class="generic">

<dt><b><a href="#HorizontalResolution"><i><code><span data-if="hdevelop" style="display:inline">HorizontalResolution</span><span data-if="c" style="display:none">HorizontalResolution</span><span data-if="cpp" style="display:none">HorizontalResolution</span><span data-if="com" style="display:none">HorizontalResolution</span><span data-if="dotnet" style="display:none">horizontalResolution</span><span data-if="python" style="display:none">horizontal_resolution</span></code></i></a>, <a href="#VerticalResolution"><i><code><span data-if="hdevelop" style="display:inline">VerticalResolution</span><span data-if="c" style="display:none">VerticalResolution</span><span data-if="cpp" style="display:none">VerticalResolution</span><span data-if="com" style="display:none">VerticalResolution</span><span data-if="dotnet" style="display:none">verticalResolution</span><span data-if="python" style="display:none">vertical_resolution</span></code></i></a></b></dt>
<dd><p>

Desired resolution of the image acquisition
device.
</p></dd>

<dt><b><a href="#ImageWidth"><i><code><span data-if="hdevelop" style="display:inline">ImageWidth</span><span data-if="c" style="display:none">ImageWidth</span><span data-if="cpp" style="display:none">ImageWidth</span><span data-if="com" style="display:none">ImageWidth</span><span data-if="dotnet" style="display:none">imageWidth</span><span data-if="python" style="display:none">image_width</span></code></i></a>, <a href="#ImageHeight"><i><code><span data-if="hdevelop" style="display:inline">ImageHeight</span><span data-if="c" style="display:none">ImageHeight</span><span data-if="cpp" style="display:none">ImageHeight</span><span data-if="com" style="display:none">ImageHeight</span><span data-if="dotnet" style="display:none">imageHeight</span><span data-if="python" style="display:none">image_height</span></code></i></a></b></dt>
<dd><p>

Size of the image part to be returned
by <a href="grab_image.html"><code><span data-if="hdevelop" style="display:inline">grab_image</span><span data-if="c" style="display:none">grab_image</span><span data-if="cpp" style="display:none">GrabImage</span><span data-if="com" style="display:none">GrabImage</span><span data-if="dotnet" style="display:none">GrabImage</span><span data-if="python" style="display:none">grab_image</span></code></a> etc.
</p></dd>

<dt><b><a href="#StartRow"><i><code><span data-if="hdevelop" style="display:inline">StartRow</span><span data-if="c" style="display:none">StartRow</span><span data-if="cpp" style="display:none">StartRow</span><span data-if="com" style="display:none">StartRow</span><span data-if="dotnet" style="display:none">startRow</span><span data-if="python" style="display:none">start_row</span></code></i></a>, <a href="#StartColumn"><i><code><span data-if="hdevelop" style="display:inline">StartColumn</span><span data-if="c" style="display:none">StartColumn</span><span data-if="cpp" style="display:none">StartColumn</span><span data-if="com" style="display:none">StartColumn</span><span data-if="dotnet" style="display:none">startColumn</span><span data-if="python" style="display:none">start_column</span></code></i></a></b></dt>
<dd><p>

Upper left corner of the desired image area.
</p></dd>

<dt><b><a href="#Field"><i><code><span data-if="hdevelop" style="display:inline">Field</span><span data-if="c" style="display:none">Field</span><span data-if="cpp" style="display:none">Field</span><span data-if="com" style="display:none">Field</span><span data-if="dotnet" style="display:none">field</span><span data-if="python" style="display:none">field</span></code></i></a></b></dt>
<dd><p>
       Desired half image (<i><span data-if="hdevelop" style="display:inline">'first'</span><span data-if="c" style="display:none">"first"</span><span data-if="cpp" style="display:none">"first"</span><span data-if="com" style="display:none">"first"</span><span data-if="dotnet" style="display:none">"first"</span><span data-if="python" style="display:none">"first"</span></i>,
<i><span data-if="hdevelop" style="display:inline">'second'</span><span data-if="c" style="display:none">"second"</span><span data-if="cpp" style="display:none">"second"</span><span data-if="com" style="display:none">"second"</span><span data-if="dotnet" style="display:none">"second"</span><span data-if="python" style="display:none">"second"</span></i>, or <i><span data-if="hdevelop" style="display:inline">'next'</span><span data-if="c" style="display:none">"next"</span><span data-if="cpp" style="display:none">"next"</span><span data-if="com" style="display:none">"next"</span><span data-if="dotnet" style="display:none">"next"</span><span data-if="python" style="display:none">"next"</span></i>) or
selection of a full image.
</p></dd>

<dt><b><a href="#BitsPerChannel"><i><code><span data-if="hdevelop" style="display:inline">BitsPerChannel</span><span data-if="c" style="display:none">BitsPerChannel</span><span data-if="cpp" style="display:none">BitsPerChannel</span><span data-if="com" style="display:none">BitsPerChannel</span><span data-if="dotnet" style="display:none">bitsPerChannel</span><span data-if="python" style="display:none">bits_per_channel</span></code></i></a></b></dt>
<dd><p>

Number of bits, which are transferred from the
image acquisition device per pixel and image
channel (typically <i>5</i>, <i>8</i>,
<i>10</i>, <i>12</i>, or <i>16</i>).
</p></dd>

<dt><b><a href="#ColorSpace"><i><code><span data-if="hdevelop" style="display:inline">ColorSpace</span><span data-if="c" style="display:none">ColorSpace</span><span data-if="cpp" style="display:none">ColorSpace</span><span data-if="com" style="display:none">ColorSpace</span><span data-if="dotnet" style="display:none">colorSpace</span><span data-if="python" style="display:none">color_space</span></code></i></a></b></dt>
<dd><p>
  Output color format of the grabbed images
(typically <i><span data-if="hdevelop" style="display:inline">'gray'</span><span data-if="c" style="display:none">"gray"</span><span data-if="cpp" style="display:none">"gray"</span><span data-if="com" style="display:none">"gray"</span><span data-if="dotnet" style="display:none">"gray"</span><span data-if="python" style="display:none">"gray"</span></i> or <i><span data-if="hdevelop" style="display:inline">'raw'</span><span data-if="c" style="display:none">"raw"</span><span data-if="cpp" style="display:none">"raw"</span><span data-if="com" style="display:none">"raw"</span><span data-if="dotnet" style="display:none">"raw"</span><span data-if="python" style="display:none">"raw"</span></i> for
single-channel or <i><span data-if="hdevelop" style="display:inline">'rgb'</span><span data-if="c" style="display:none">"rgb"</span><span data-if="cpp" style="display:none">"rgb"</span><span data-if="com" style="display:none">"rgb"</span><span data-if="dotnet" style="display:none">"rgb"</span><span data-if="python" style="display:none">"rgb"</span></i> or <i><span data-if="hdevelop" style="display:inline">'yuv'</span><span data-if="c" style="display:none">"yuv"</span><span data-if="cpp" style="display:none">"yuv"</span><span data-if="com" style="display:none">"yuv"</span><span data-if="dotnet" style="display:none">"yuv"</span><span data-if="python" style="display:none">"yuv"</span></i>
for three-channel images).
</p></dd>

<dt><b><a href="#Generic"><i><code><span data-if="hdevelop" style="display:inline">Generic</span><span data-if="c" style="display:none">Generic</span><span data-if="cpp" style="display:none">Generic</span><span data-if="com" style="display:none">Generic</span><span data-if="dotnet" style="display:none">generic</span><span data-if="python" style="display:none">generic</span></code></i></a></b></dt>
<dd><p>
     Generic parameter with device-specific
meaning which can be queried
by <a href="info_framegrabber.html"><code><span data-if="hdevelop" style="display:inline">info_framegrabber</span><span data-if="c" style="display:none">info_framegrabber</span><span data-if="cpp" style="display:none">InfoFramegrabber</span><span data-if="com" style="display:none">InfoFramegrabber</span><span data-if="dotnet" style="display:none">InfoFramegrabber</span><span data-if="python" style="display:none">info_framegrabber</span></code></a>.
</p></dd>

<dt><b><a href="#ExternalTrigger"><i><code><span data-if="hdevelop" style="display:inline">ExternalTrigger</span><span data-if="c" style="display:none">ExternalTrigger</span><span data-if="cpp" style="display:none">ExternalTrigger</span><span data-if="com" style="display:none">ExternalTrigger</span><span data-if="dotnet" style="display:none">externalTrigger</span><span data-if="python" style="display:none">external_trigger</span></code></i></a></b></dt>
<dd><p>

Activation of external triggering (if
available).
</p></dd>

<dt><b><a href="#CameraType"><i><code><span data-if="hdevelop" style="display:inline">CameraType</span><span data-if="c" style="display:none">CameraType</span><span data-if="cpp" style="display:none">CameraType</span><span data-if="com" style="display:none">CameraType</span><span data-if="dotnet" style="display:none">cameraType</span><span data-if="python" style="display:none">camera_type</span></code></i></a></b></dt>
<dd><p>
  More detailed specification of the desired
image acquisition device (typically the type
of the analog video format or the name of the
desired camera configuration file).
</p></dd>

<dt><b><a href="#Device"><i><code><span data-if="hdevelop" style="display:inline">Device</span><span data-if="c" style="display:none">Device</span><span data-if="cpp" style="display:none">Device</span><span data-if="com" style="display:none">Device</span><span data-if="dotnet" style="display:none">device</span><span data-if="python" style="display:none">device</span></code></i></a></b></dt>
<dd><p>
      Device name of the image acquisition device.
</p></dd>

<dt><b><a href="#Port"><i><code><span data-if="hdevelop" style="display:inline">Port</span><span data-if="c" style="display:none">Port</span><span data-if="cpp" style="display:none">Port</span><span data-if="com" style="display:none">Port</span><span data-if="dotnet" style="display:none">port</span><span data-if="python" style="display:none">port</span></code></i></a></b></dt>
<dd><p>
        Port the image acquisition device is connected to.
</p></dd>

<dt><b><a href="#LineIn"><i><code><span data-if="hdevelop" style="display:inline">LineIn</span><span data-if="c" style="display:none">LineIn</span><span data-if="cpp" style="display:none">LineIn</span><span data-if="com" style="display:none">LineIn</span><span data-if="dotnet" style="display:none">lineIn</span><span data-if="python" style="display:none">line_in</span></code></i></a></b></dt>
<dd><p>
      Camera input line of multiplexer (if available).
</p></dd>
</dl>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">open_framegrabber</span><span data-if="c" style="display:none">open_framegrabber</span><span data-if="cpp" style="display:none">OpenFramegrabber</span><span data-if="com" style="display:none">OpenFramegrabber</span><span data-if="dotnet" style="display:none">OpenFramegrabber</span><span data-if="python" style="display:none">open_framegrabber</span></code> returns a handle
(<a href="#AcqHandle"><i><code><span data-if="hdevelop" style="display:inline">AcqHandle</span><span data-if="c" style="display:none">AcqHandle</span><span data-if="cpp" style="display:none">AcqHandle</span><span data-if="com" style="display:none">AcqHandle</span><span data-if="dotnet" style="display:none">acqHandle</span><span data-if="python" style="display:none">acq_handle</span></code></i></a>) to the opened image acquisition device.</p>
<h2 id="sec_attention">注意</h2>
<p>Due to the multitude of supported image acquisition devices,
<code><span data-if="hdevelop" style="display:inline">open_framegrabber</span><span data-if="c" style="display:none">open_framegrabber</span><span data-if="cpp" style="display:none">OpenFramegrabber</span><span data-if="com" style="display:none">OpenFramegrabber</span><span data-if="dotnet" style="display:none">OpenFramegrabber</span><span data-if="python" style="display:none">open_framegrabber</span></code> contains a large number of parameters.  However,
not all parameters are needed for a specific image acquisition device.
</p>
<p>For a multithreaded application,
<a href="info_framegrabber.html"><code><span data-if="hdevelop" style="display:inline">info_framegrabber</span><span data-if="c" style="display:none">info_framegrabber</span><span data-if="cpp" style="display:none">InfoFramegrabber</span><span data-if="com" style="display:none">InfoFramegrabber</span><span data-if="dotnet" style="display:none">InfoFramegrabber</span><span data-if="python" style="display:none">info_framegrabber</span></code></a>, <code><span data-if="hdevelop" style="display:inline">open_framegrabber</span><span data-if="c" style="display:none">open_framegrabber</span><span data-if="cpp" style="display:none">OpenFramegrabber</span><span data-if="com" style="display:none">OpenFramegrabber</span><span data-if="dotnet" style="display:none">OpenFramegrabber</span><span data-if="python" style="display:none">open_framegrabber</span></code>, and
<a href="close_framegrabber.html"><code><span data-if="hdevelop" style="display:inline">close_framegrabber</span><span data-if="c" style="display:none">close_framegrabber</span><span data-if="cpp" style="display:none">CloseFramegrabber</span><span data-if="com" style="display:none">CloseFramegrabber</span><span data-if="dotnet" style="display:none">CloseFramegrabber</span><span data-if="python" style="display:none">close_framegrabber</span></code></a> are executed exclusively. Thus,
they block the concurrent execution of each other, but run in
parallel with all non-exclusive operators outside of this group.
</p>
<p>On Windows Systems, error dialog boxes from the operating system can occur
when dependency modules of the interface are not found, e.g., the according
SDK was not installed. The occurrence of the error boxes can be controlled
by setting Windows' Error Mode. Please refer to the description of
SetErrorMode within the Windows MSDN documentation.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<p>This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.</p>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Name" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Name</span><span data-if="c" style="display:none">Name</span><span data-if="cpp" style="display:none">Name</span><span data-if="com" style="display:none">Name</span><span data-if="dotnet" style="display:none">name</span><span data-if="python" style="display:none">name</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">HALCON image acquisition interface name, i.e.,
name of the corresponding DLL (Windows) or
shared library (Linux).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'File'</span>
    <span data-if="c" style="display:none">"File"</span>
    <span data-if="cpp" style="display:none">"File"</span>
    <span data-if="com" style="display:none">"File"</span>
    <span data-if="dotnet" style="display:none">"File"</span>
    <span data-if="python" style="display:none">"File"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'ABS'</span><span data-if="c" style="display:none">"ABS"</span><span data-if="cpp" style="display:none">"ABS"</span><span data-if="com" style="display:none">"ABS"</span><span data-if="dotnet" style="display:none">"ABS"</span><span data-if="python" style="display:none">"ABS"</span>, <span data-if="hdevelop" style="display:inline">'ADLINK'</span><span data-if="c" style="display:none">"ADLINK"</span><span data-if="cpp" style="display:none">"ADLINK"</span><span data-if="com" style="display:none">"ADLINK"</span><span data-if="dotnet" style="display:none">"ADLINK"</span><span data-if="python" style="display:none">"ADLINK"</span>, <span data-if="hdevelop" style="display:inline">'AlkUSB3'</span><span data-if="c" style="display:none">"AlkUSB3"</span><span data-if="cpp" style="display:none">"AlkUSB3"</span><span data-if="com" style="display:none">"AlkUSB3"</span><span data-if="dotnet" style="display:none">"AlkUSB3"</span><span data-if="python" style="display:none">"AlkUSB3"</span>, <span data-if="hdevelop" style="display:inline">'Andor'</span><span data-if="c" style="display:none">"Andor"</span><span data-if="cpp" style="display:none">"Andor"</span><span data-if="com" style="display:none">"Andor"</span><span data-if="dotnet" style="display:none">"Andor"</span><span data-if="python" style="display:none">"Andor"</span>, <span data-if="hdevelop" style="display:inline">'BitFlow'</span><span data-if="c" style="display:none">"BitFlow"</span><span data-if="cpp" style="display:none">"BitFlow"</span><span data-if="com" style="display:none">"BitFlow"</span><span data-if="dotnet" style="display:none">"BitFlow"</span><span data-if="python" style="display:none">"BitFlow"</span>, <span data-if="hdevelop" style="display:inline">'Crevis'</span><span data-if="c" style="display:none">"Crevis"</span><span data-if="cpp" style="display:none">"Crevis"</span><span data-if="com" style="display:none">"Crevis"</span><span data-if="dotnet" style="display:none">"Crevis"</span><span data-if="python" style="display:none">"Crevis"</span>, <span data-if="hdevelop" style="display:inline">'DahengCAM'</span><span data-if="c" style="display:none">"DahengCAM"</span><span data-if="cpp" style="display:none">"DahengCAM"</span><span data-if="com" style="display:none">"DahengCAM"</span><span data-if="dotnet" style="display:none">"DahengCAM"</span><span data-if="python" style="display:none">"DahengCAM"</span>, <span data-if="hdevelop" style="display:inline">'DirectFile'</span><span data-if="c" style="display:none">"DirectFile"</span><span data-if="cpp" style="display:none">"DirectFile"</span><span data-if="com" style="display:none">"DirectFile"</span><span data-if="dotnet" style="display:none">"DirectFile"</span><span data-if="python" style="display:none">"DirectFile"</span>, <span data-if="hdevelop" style="display:inline">'DirectShow'</span><span data-if="c" style="display:none">"DirectShow"</span><span data-if="cpp" style="display:none">"DirectShow"</span><span data-if="com" style="display:none">"DirectShow"</span><span data-if="dotnet" style="display:none">"DirectShow"</span><span data-if="python" style="display:none">"DirectShow"</span>, <span data-if="hdevelop" style="display:inline">'Ensenso-NxLib'</span><span data-if="c" style="display:none">"Ensenso-NxLib"</span><span data-if="cpp" style="display:none">"Ensenso-NxLib"</span><span data-if="com" style="display:none">"Ensenso-NxLib"</span><span data-if="dotnet" style="display:none">"Ensenso-NxLib"</span><span data-if="python" style="display:none">"Ensenso-NxLib"</span>, <span data-if="hdevelop" style="display:inline">'File'</span><span data-if="c" style="display:none">"File"</span><span data-if="cpp" style="display:none">"File"</span><span data-if="com" style="display:none">"File"</span><span data-if="dotnet" style="display:none">"File"</span><span data-if="python" style="display:none">"File"</span>, <span data-if="hdevelop" style="display:inline">'FocalSpecLCI'</span><span data-if="c" style="display:none">"FocalSpecLCI"</span><span data-if="cpp" style="display:none">"FocalSpecLCI"</span><span data-if="com" style="display:none">"FocalSpecLCI"</span><span data-if="dotnet" style="display:none">"FocalSpecLCI"</span><span data-if="python" style="display:none">"FocalSpecLCI"</span>, <span data-if="hdevelop" style="display:inline">'GenICamTL'</span><span data-if="c" style="display:none">"GenICamTL"</span><span data-if="cpp" style="display:none">"GenICamTL"</span><span data-if="com" style="display:none">"GenICamTL"</span><span data-if="dotnet" style="display:none">"GenICamTL"</span><span data-if="python" style="display:none">"GenICamTL"</span>, <span data-if="hdevelop" style="display:inline">'GigEVision2'</span><span data-if="c" style="display:none">"GigEVision2"</span><span data-if="cpp" style="display:none">"GigEVision2"</span><span data-if="com" style="display:none">"GigEVision2"</span><span data-if="dotnet" style="display:none">"GigEVision2"</span><span data-if="python" style="display:none">"GigEVision2"</span>, <span data-if="hdevelop" style="display:inline">'GingaDG'</span><span data-if="c" style="display:none">"GingaDG"</span><span data-if="cpp" style="display:none">"GingaDG"</span><span data-if="com" style="display:none">"GingaDG"</span><span data-if="dotnet" style="display:none">"GingaDG"</span><span data-if="python" style="display:none">"GingaDG"</span>, <span data-if="hdevelop" style="display:inline">'Ginga++'</span><span data-if="c" style="display:none">"Ginga++"</span><span data-if="cpp" style="display:none">"Ginga++"</span><span data-if="com" style="display:none">"Ginga++"</span><span data-if="dotnet" style="display:none">"Ginga++"</span><span data-if="python" style="display:none">"Ginga++"</span>, <span data-if="hdevelop" style="display:inline">'GStreamer'</span><span data-if="c" style="display:none">"GStreamer"</span><span data-if="cpp" style="display:none">"GStreamer"</span><span data-if="com" style="display:none">"GStreamer"</span><span data-if="dotnet" style="display:none">"GStreamer"</span><span data-if="python" style="display:none">"GStreamer"</span>, <span data-if="hdevelop" style="display:inline">'heliCamC3'</span><span data-if="c" style="display:none">"heliCamC3"</span><span data-if="cpp" style="display:none">"heliCamC3"</span><span data-if="com" style="display:none">"heliCamC3"</span><span data-if="dotnet" style="display:none">"heliCamC3"</span><span data-if="python" style="display:none">"heliCamC3"</span>, <span data-if="hdevelop" style="display:inline">'KeyenceVJ'</span><span data-if="c" style="display:none">"KeyenceVJ"</span><span data-if="cpp" style="display:none">"KeyenceVJ"</span><span data-if="com" style="display:none">"KeyenceVJ"</span><span data-if="dotnet" style="display:none">"KeyenceVJ"</span><span data-if="python" style="display:none">"KeyenceVJ"</span>, <span data-if="hdevelop" style="display:inline">'LinX'</span><span data-if="c" style="display:none">"LinX"</span><span data-if="cpp" style="display:none">"LinX"</span><span data-if="com" style="display:none">"LinX"</span><span data-if="dotnet" style="display:none">"LinX"</span><span data-if="python" style="display:none">"LinX"</span>, <span data-if="hdevelop" style="display:inline">'LPS36'</span><span data-if="c" style="display:none">"LPS36"</span><span data-if="cpp" style="display:none">"LPS36"</span><span data-if="com" style="display:none">"LPS36"</span><span data-if="dotnet" style="display:none">"LPS36"</span><span data-if="python" style="display:none">"LPS36"</span>, <span data-if="hdevelop" style="display:inline">'LuCam'</span><span data-if="c" style="display:none">"LuCam"</span><span data-if="cpp" style="display:none">"LuCam"</span><span data-if="com" style="display:none">"LuCam"</span><span data-if="dotnet" style="display:none">"LuCam"</span><span data-if="python" style="display:none">"LuCam"</span>, <span data-if="hdevelop" style="display:inline">'MatrixVisionAcquire'</span><span data-if="c" style="display:none">"MatrixVisionAcquire"</span><span data-if="cpp" style="display:none">"MatrixVisionAcquire"</span><span data-if="com" style="display:none">"MatrixVisionAcquire"</span><span data-if="dotnet" style="display:none">"MatrixVisionAcquire"</span><span data-if="python" style="display:none">"MatrixVisionAcquire"</span>, <span data-if="hdevelop" style="display:inline">'MediaFoundation'</span><span data-if="c" style="display:none">"MediaFoundation"</span><span data-if="cpp" style="display:none">"MediaFoundation"</span><span data-if="com" style="display:none">"MediaFoundation"</span><span data-if="dotnet" style="display:none">"MediaFoundation"</span><span data-if="python" style="display:none">"MediaFoundation"</span>, <span data-if="hdevelop" style="display:inline">'MILLite'</span><span data-if="c" style="display:none">"MILLite"</span><span data-if="cpp" style="display:none">"MILLite"</span><span data-if="com" style="display:none">"MILLite"</span><span data-if="dotnet" style="display:none">"MILLite"</span><span data-if="python" style="display:none">"MILLite"</span>, <span data-if="hdevelop" style="display:inline">'MultiCam'</span><span data-if="c" style="display:none">"MultiCam"</span><span data-if="cpp" style="display:none">"MultiCam"</span><span data-if="com" style="display:none">"MultiCam"</span><span data-if="dotnet" style="display:none">"MultiCam"</span><span data-if="python" style="display:none">"MultiCam"</span>, <span data-if="hdevelop" style="display:inline">'O3D3xx'</span><span data-if="c" style="display:none">"O3D3xx"</span><span data-if="cpp" style="display:none">"O3D3xx"</span><span data-if="com" style="display:none">"O3D3xx"</span><span data-if="dotnet" style="display:none">"O3D3xx"</span><span data-if="python" style="display:none">"O3D3xx"</span>, <span data-if="hdevelop" style="display:inline">'Opteon'</span><span data-if="c" style="display:none">"Opteon"</span><span data-if="cpp" style="display:none">"Opteon"</span><span data-if="com" style="display:none">"Opteon"</span><span data-if="dotnet" style="display:none">"Opteon"</span><span data-if="python" style="display:none">"Opteon"</span>, <span data-if="hdevelop" style="display:inline">'PhoXi'</span><span data-if="c" style="display:none">"PhoXi"</span><span data-if="cpp" style="display:none">"PhoXi"</span><span data-if="com" style="display:none">"PhoXi"</span><span data-if="dotnet" style="display:none">"PhoXi"</span><span data-if="python" style="display:none">"PhoXi"</span>, <span data-if="hdevelop" style="display:inline">'PixeLINK'</span><span data-if="c" style="display:none">"PixeLINK"</span><span data-if="cpp" style="display:none">"PixeLINK"</span><span data-if="com" style="display:none">"PixeLINK"</span><span data-if="dotnet" style="display:none">"PixeLINK"</span><span data-if="python" style="display:none">"PixeLINK"</span>, <span data-if="hdevelop" style="display:inline">'pylon'</span><span data-if="c" style="display:none">"pylon"</span><span data-if="cpp" style="display:none">"pylon"</span><span data-if="com" style="display:none">"pylon"</span><span data-if="dotnet" style="display:none">"pylon"</span><span data-if="python" style="display:none">"pylon"</span>, <span data-if="hdevelop" style="display:inline">'RealSense'</span><span data-if="c" style="display:none">"RealSense"</span><span data-if="cpp" style="display:none">"RealSense"</span><span data-if="com" style="display:none">"RealSense"</span><span data-if="dotnet" style="display:none">"RealSense"</span><span data-if="python" style="display:none">"RealSense"</span>, <span data-if="hdevelop" style="display:inline">'SaperaLT'</span><span data-if="c" style="display:none">"SaperaLT"</span><span data-if="cpp" style="display:none">"SaperaLT"</span><span data-if="com" style="display:none">"SaperaLT"</span><span data-if="dotnet" style="display:none">"SaperaLT"</span><span data-if="python" style="display:none">"SaperaLT"</span>, <span data-if="hdevelop" style="display:inline">'Sentech'</span><span data-if="c" style="display:none">"Sentech"</span><span data-if="cpp" style="display:none">"Sentech"</span><span data-if="com" style="display:none">"Sentech"</span><span data-if="dotnet" style="display:none">"Sentech"</span><span data-if="python" style="display:none">"Sentech"</span>, <span data-if="hdevelop" style="display:inline">'SICK-3DCamera'</span><span data-if="c" style="display:none">"SICK-3DCamera"</span><span data-if="cpp" style="display:none">"SICK-3DCamera"</span><span data-if="com" style="display:none">"SICK-3DCamera"</span><span data-if="dotnet" style="display:none">"SICK-3DCamera"</span><span data-if="python" style="display:none">"SICK-3DCamera"</span>, <span data-if="hdevelop" style="display:inline">'SICK-ScanningRuler'</span><span data-if="c" style="display:none">"SICK-ScanningRuler"</span><span data-if="cpp" style="display:none">"SICK-ScanningRuler"</span><span data-if="com" style="display:none">"SICK-ScanningRuler"</span><span data-if="dotnet" style="display:none">"SICK-ScanningRuler"</span><span data-if="python" style="display:none">"SICK-ScanningRuler"</span>, <span data-if="hdevelop" style="display:inline">'SiliconSoftware'</span><span data-if="c" style="display:none">"SiliconSoftware"</span><span data-if="cpp" style="display:none">"SiliconSoftware"</span><span data-if="com" style="display:none">"SiliconSoftware"</span><span data-if="dotnet" style="display:none">"SiliconSoftware"</span><span data-if="python" style="display:none">"SiliconSoftware"</span>, <span data-if="hdevelop" style="display:inline">'Slink'</span><span data-if="c" style="display:none">"Slink"</span><span data-if="cpp" style="display:none">"Slink"</span><span data-if="com" style="display:none">"Slink"</span><span data-if="dotnet" style="display:none">"Slink"</span><span data-if="python" style="display:none">"Slink"</span>, <span data-if="hdevelop" style="display:inline">'TWAIN'</span><span data-if="c" style="display:none">"TWAIN"</span><span data-if="cpp" style="display:none">"TWAIN"</span><span data-if="com" style="display:none">"TWAIN"</span><span data-if="dotnet" style="display:none">"TWAIN"</span><span data-if="python" style="display:none">"TWAIN"</span>, <span data-if="hdevelop" style="display:inline">'uEye'</span><span data-if="c" style="display:none">"uEye"</span><span data-if="cpp" style="display:none">"uEye"</span><span data-if="com" style="display:none">"uEye"</span><span data-if="dotnet" style="display:none">"uEye"</span><span data-if="python" style="display:none">"uEye"</span>, <span data-if="hdevelop" style="display:inline">'USB3Vision'</span><span data-if="c" style="display:none">"USB3Vision"</span><span data-if="cpp" style="display:none">"USB3Vision"</span><span data-if="com" style="display:none">"USB3Vision"</span><span data-if="dotnet" style="display:none">"USB3Vision"</span><span data-if="python" style="display:none">"USB3Vision"</span>, <span data-if="hdevelop" style="display:inline">'Video4Linux2'</span><span data-if="c" style="display:none">"Video4Linux2"</span><span data-if="cpp" style="display:none">"Video4Linux2"</span><span data-if="com" style="display:none">"Video4Linux2"</span><span data-if="dotnet" style="display:none">"Video4Linux2"</span><span data-if="python" style="display:none">"Video4Linux2"</span>, <span data-if="hdevelop" style="display:inline">'VRmUsbCam'</span><span data-if="c" style="display:none">"VRmUsbCam"</span><span data-if="cpp" style="display:none">"VRmUsbCam"</span><span data-if="com" style="display:none">"VRmUsbCam"</span><span data-if="dotnet" style="display:none">"VRmUsbCam"</span><span data-if="python" style="display:none">"VRmUsbCam"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="HorizontalResolution" class="parname"><b><code><span data-if="hdevelop" style="display:inline">HorizontalResolution</span><span data-if="c" style="display:none">HorizontalResolution</span><span data-if="cpp" style="display:none">HorizontalResolution</span><span data-if="com" style="display:none">HorizontalResolution</span><span data-if="dotnet" style="display:none">horizontalResolution</span><span data-if="python" style="display:none">horizontal_resolution</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Desired horizontal resolution of image acquisition
interface (absolute value or <i>1</i> for full
resolution, <i>2</i> for half resolution, or
<i>4</i> for quarter resolution).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1, 2, 4, 1600, 1280, 768, 640, 384, 320, 192, 160, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="VerticalResolution" class="parname"><b><code><span data-if="hdevelop" style="display:inline">VerticalResolution</span><span data-if="c" style="display:none">VerticalResolution</span><span data-if="cpp" style="display:none">VerticalResolution</span><span data-if="com" style="display:none">VerticalResolution</span><span data-if="dotnet" style="display:none">verticalResolution</span><span data-if="python" style="display:none">vertical_resolution</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Desired vertical resolution of image acquisition
interface (absolute value or <i>1</i> for full resolution,
<i>2</i> for half resolution, or <i>4</i> for quarter
resolution).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1, 2, 4, 1200, 1024, 576, 480, 288, 240, 144, 120, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageWidth</span><span data-if="c" style="display:none">ImageWidth</span><span data-if="cpp" style="display:none">ImageWidth</span><span data-if="com" style="display:none">ImageWidth</span><span data-if="dotnet" style="display:none">imageWidth</span><span data-if="python" style="display:none">image_width</span></code></b> (input_control)  </span><span>rectangle.extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of desired image part
(absolute value or <i>0</i> for
<a href="#HorizontalResolution"><i><code><span data-if="hdevelop" style="display:inline">HorizontalResolution</span><span data-if="c" style="display:none">HorizontalResolution</span><span data-if="cpp" style="display:none">HorizontalResolution</span><span data-if="com" style="display:none">HorizontalResolution</span><span data-if="dotnet" style="display:none">horizontalResolution</span><span data-if="python" style="display:none">horizontal_resolution</span></code></i></a> -
2*<a href="#StartColumn"><i><code><span data-if="hdevelop" style="display:inline">StartColumn</span><span data-if="c" style="display:none">StartColumn</span><span data-if="cpp" style="display:none">StartColumn</span><span data-if="com" style="display:none">StartColumn</span><span data-if="dotnet" style="display:none">startColumn</span><span data-if="python" style="display:none">start_column</span></code></i></a>).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageHeight" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageHeight</span><span data-if="c" style="display:none">ImageHeight</span><span data-if="cpp" style="display:none">ImageHeight</span><span data-if="com" style="display:none">ImageHeight</span><span data-if="dotnet" style="display:none">imageHeight</span><span data-if="python" style="display:none">image_height</span></code></b> (input_control)  </span><span>rectangle.extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Height of desired image part
(absolute value or <i>0</i> for
<a href="#VerticalResolution"><i><code><span data-if="hdevelop" style="display:inline">VerticalResolution</span><span data-if="c" style="display:none">VerticalResolution</span><span data-if="cpp" style="display:none">VerticalResolution</span><span data-if="com" style="display:none">VerticalResolution</span><span data-if="dotnet" style="display:none">verticalResolution</span><span data-if="python" style="display:none">vertical_resolution</span></code></i></a> - 2*<a href="#StartRow"><i><code><span data-if="hdevelop" style="display:inline">StartRow</span><span data-if="c" style="display:none">StartRow</span><span data-if="cpp" style="display:none">StartRow</span><span data-if="com" style="display:none">StartRow</span><span data-if="dotnet" style="display:none">startRow</span><span data-if="python" style="display:none">start_row</span></code></i></a>).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="StartRow" class="parname"><b><code><span data-if="hdevelop" style="display:inline">StartRow</span><span data-if="c" style="display:none">StartRow</span><span data-if="cpp" style="display:none">StartRow</span><span data-if="com" style="display:none">StartRow</span><span data-if="dotnet" style="display:none">startRow</span><span data-if="python" style="display:none">start_row</span></code></b> (input_control)  </span><span>rectangle.origin.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Line number of upper left corner of desired
image part (or border height if
<a href="#ImageHeight"><i><code><span data-if="hdevelop" style="display:inline">ImageHeight</span><span data-if="c" style="display:none">ImageHeight</span><span data-if="cpp" style="display:none">ImageHeight</span><span data-if="com" style="display:none">ImageHeight</span><span data-if="dotnet" style="display:none">imageHeight</span><span data-if="python" style="display:none">image_height</span></code></i></a> = <i>0</i>).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="StartColumn" class="parname"><b><code><span data-if="hdevelop" style="display:inline">StartColumn</span><span data-if="c" style="display:none">StartColumn</span><span data-if="cpp" style="display:none">StartColumn</span><span data-if="com" style="display:none">StartColumn</span><span data-if="dotnet" style="display:none">startColumn</span><span data-if="python" style="display:none">start_column</span></code></b> (input_control)  </span><span>rectangle.origin.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Column number of upper left corner of desired
image part (or border width if
<a href="#ImageWidth"><i><code><span data-if="hdevelop" style="display:inline">ImageWidth</span><span data-if="c" style="display:none">ImageWidth</span><span data-if="cpp" style="display:none">ImageWidth</span><span data-if="com" style="display:none">ImageWidth</span><span data-if="dotnet" style="display:none">imageWidth</span><span data-if="python" style="display:none">image_width</span></code></i></a> = <i>0</i>).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Field" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Field</span><span data-if="c" style="display:none">Field</span><span data-if="cpp" style="display:none">Field</span><span data-if="com" style="display:none">Field</span><span data-if="dotnet" style="display:none">field</span><span data-if="python" style="display:none">field</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Desired half image or full image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'default'</span>
    <span data-if="c" style="display:none">"default"</span>
    <span data-if="cpp" style="display:none">"default"</span>
    <span data-if="com" style="display:none">"default"</span>
    <span data-if="dotnet" style="display:none">"default"</span>
    <span data-if="python" style="display:none">"default"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'first'</span><span data-if="c" style="display:none">"first"</span><span data-if="cpp" style="display:none">"first"</span><span data-if="com" style="display:none">"first"</span><span data-if="dotnet" style="display:none">"first"</span><span data-if="python" style="display:none">"first"</span>, <span data-if="hdevelop" style="display:inline">'second'</span><span data-if="c" style="display:none">"second"</span><span data-if="cpp" style="display:none">"second"</span><span data-if="com" style="display:none">"second"</span><span data-if="dotnet" style="display:none">"second"</span><span data-if="python" style="display:none">"second"</span>, <span data-if="hdevelop" style="display:inline">'next'</span><span data-if="c" style="display:none">"next"</span><span data-if="cpp" style="display:none">"next"</span><span data-if="com" style="display:none">"next"</span><span data-if="dotnet" style="display:none">"next"</span><span data-if="python" style="display:none">"next"</span>, <span data-if="hdevelop" style="display:inline">'interlaced'</span><span data-if="c" style="display:none">"interlaced"</span><span data-if="cpp" style="display:none">"interlaced"</span><span data-if="com" style="display:none">"interlaced"</span><span data-if="dotnet" style="display:none">"interlaced"</span><span data-if="python" style="display:none">"interlaced"</span>, <span data-if="hdevelop" style="display:inline">'progressive'</span><span data-if="c" style="display:none">"progressive"</span><span data-if="cpp" style="display:none">"progressive"</span><span data-if="com" style="display:none">"progressive"</span><span data-if="dotnet" style="display:none">"progressive"</span><span data-if="python" style="display:none">"progressive"</span>, <span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="BitsPerChannel" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BitsPerChannel</span><span data-if="c" style="display:none">BitsPerChannel</span><span data-if="cpp" style="display:none">BitsPerChannel</span><span data-if="com" style="display:none">BitsPerChannel</span><span data-if="dotnet" style="display:none">bitsPerChannel</span><span data-if="python" style="display:none">bits_per_channel</span></code></b> (input_control)  </span><span>integer(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of transferred bits per pixel and image
channel (-1: device-specific default value).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>-1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>5, 8, 10, 12, 14, 16, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ColorSpace" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ColorSpace</span><span data-if="c" style="display:none">ColorSpace</span><span data-if="cpp" style="display:none">ColorSpace</span><span data-if="com" style="display:none">ColorSpace</span><span data-if="dotnet" style="display:none">colorSpace</span><span data-if="python" style="display:none">color_space</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Output color format of the grabbed images,
typically <i><span data-if="hdevelop" style="display:inline">'gray'</span><span data-if="c" style="display:none">"gray"</span><span data-if="cpp" style="display:none">"gray"</span><span data-if="com" style="display:none">"gray"</span><span data-if="dotnet" style="display:none">"gray"</span><span data-if="python" style="display:none">"gray"</span></i> or <i><span data-if="hdevelop" style="display:inline">'raw'</span><span data-if="c" style="display:none">"raw"</span><span data-if="cpp" style="display:none">"raw"</span><span data-if="com" style="display:none">"raw"</span><span data-if="dotnet" style="display:none">"raw"</span><span data-if="python" style="display:none">"raw"</span></i> for
single-channel or <i><span data-if="hdevelop" style="display:inline">'rgb'</span><span data-if="c" style="display:none">"rgb"</span><span data-if="cpp" style="display:none">"rgb"</span><span data-if="com" style="display:none">"rgb"</span><span data-if="dotnet" style="display:none">"rgb"</span><span data-if="python" style="display:none">"rgb"</span></i> or <i><span data-if="hdevelop" style="display:inline">'yuv'</span><span data-if="c" style="display:none">"yuv"</span><span data-if="cpp" style="display:none">"yuv"</span><span data-if="com" style="display:none">"yuv"</span><span data-if="dotnet" style="display:none">"yuv"</span><span data-if="python" style="display:none">"yuv"</span></i>
for three-channel images
(<i><span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></i>: device-specific default value).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'default'</span>
    <span data-if="c" style="display:none">"default"</span>
    <span data-if="cpp" style="display:none">"default"</span>
    <span data-if="com" style="display:none">"default"</span>
    <span data-if="dotnet" style="display:none">"default"</span>
    <span data-if="python" style="display:none">"default"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'gray'</span><span data-if="c" style="display:none">"gray"</span><span data-if="cpp" style="display:none">"gray"</span><span data-if="com" style="display:none">"gray"</span><span data-if="dotnet" style="display:none">"gray"</span><span data-if="python" style="display:none">"gray"</span>, <span data-if="hdevelop" style="display:inline">'raw'</span><span data-if="c" style="display:none">"raw"</span><span data-if="cpp" style="display:none">"raw"</span><span data-if="com" style="display:none">"raw"</span><span data-if="dotnet" style="display:none">"raw"</span><span data-if="python" style="display:none">"raw"</span>, <span data-if="hdevelop" style="display:inline">'rgb'</span><span data-if="c" style="display:none">"rgb"</span><span data-if="cpp" style="display:none">"rgb"</span><span data-if="com" style="display:none">"rgb"</span><span data-if="dotnet" style="display:none">"rgb"</span><span data-if="python" style="display:none">"rgb"</span>, <span data-if="hdevelop" style="display:inline">'yuv'</span><span data-if="c" style="display:none">"yuv"</span><span data-if="cpp" style="display:none">"yuv"</span><span data-if="com" style="display:none">"yuv"</span><span data-if="dotnet" style="display:none">"yuv"</span><span data-if="python" style="display:none">"yuv"</span>, <span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Generic" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Generic</span><span data-if="c" style="display:none">Generic</span><span data-if="cpp" style="display:none">Generic</span><span data-if="com" style="display:none">Generic</span><span data-if="dotnet" style="display:none">generic</span><span data-if="python" style="display:none">generic</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[Union[str, float, int]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">string / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">string / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">HString / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">char* / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Generic parameter with device-specific meaning.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>-1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ExternalTrigger" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ExternalTrigger</span><span data-if="c" style="display:none">ExternalTrigger</span><span data-if="cpp" style="display:none">ExternalTrigger</span><span data-if="com" style="display:none">ExternalTrigger</span><span data-if="dotnet" style="display:none">externalTrigger</span><span data-if="python" style="display:none">external_trigger</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">External triggering.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'default'</span>
    <span data-if="c" style="display:none">"default"</span>
    <span data-if="cpp" style="display:none">"default"</span>
    <span data-if="com" style="display:none">"default"</span>
    <span data-if="dotnet" style="display:none">"default"</span>
    <span data-if="python" style="display:none">"default"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span>, <span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span>, <span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="CameraType" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CameraType</span><span data-if="c" style="display:none">CameraType</span><span data-if="cpp" style="display:none">CameraType</span><span data-if="com" style="display:none">CameraType</span><span data-if="dotnet" style="display:none">cameraType</span><span data-if="python" style="display:none">camera_type</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Type of used camera
(<i><span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></i>: device-specific default value).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'default'</span>
    <span data-if="c" style="display:none">"default"</span>
    <span data-if="cpp" style="display:none">"default"</span>
    <span data-if="com" style="display:none">"default"</span>
    <span data-if="dotnet" style="display:none">"default"</span>
    <span data-if="python" style="display:none">"default"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'ntsc'</span><span data-if="c" style="display:none">"ntsc"</span><span data-if="cpp" style="display:none">"ntsc"</span><span data-if="com" style="display:none">"ntsc"</span><span data-if="dotnet" style="display:none">"ntsc"</span><span data-if="python" style="display:none">"ntsc"</span>, <span data-if="hdevelop" style="display:inline">'pal'</span><span data-if="c" style="display:none">"pal"</span><span data-if="cpp" style="display:none">"pal"</span><span data-if="com" style="display:none">"pal"</span><span data-if="dotnet" style="display:none">"pal"</span><span data-if="python" style="display:none">"pal"</span>, <span data-if="hdevelop" style="display:inline">'auto'</span><span data-if="c" style="display:none">"auto"</span><span data-if="cpp" style="display:none">"auto"</span><span data-if="com" style="display:none">"auto"</span><span data-if="dotnet" style="display:none">"auto"</span><span data-if="python" style="display:none">"auto"</span>, <span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Device" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Device</span><span data-if="c" style="display:none">Device</span><span data-if="cpp" style="display:none">Device</span><span data-if="com" style="display:none">Device</span><span data-if="dotnet" style="display:none">device</span><span data-if="python" style="display:none">device</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Device the image acquisition device is connected to
(<i><span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></i>: device-specific default value).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'default'</span>
    <span data-if="c" style="display:none">"default"</span>
    <span data-if="cpp" style="display:none">"default"</span>
    <span data-if="com" style="display:none">"default"</span>
    <span data-if="dotnet" style="display:none">"default"</span>
    <span data-if="python" style="display:none">"default"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'-1'</span><span data-if="c" style="display:none">"-1"</span><span data-if="cpp" style="display:none">"-1"</span><span data-if="com" style="display:none">"-1"</span><span data-if="dotnet" style="display:none">"-1"</span><span data-if="python" style="display:none">"-1"</span>, <span data-if="hdevelop" style="display:inline">'0'</span><span data-if="c" style="display:none">"0"</span><span data-if="cpp" style="display:none">"0"</span><span data-if="com" style="display:none">"0"</span><span data-if="dotnet" style="display:none">"0"</span><span data-if="python" style="display:none">"0"</span>, <span data-if="hdevelop" style="display:inline">'1'</span><span data-if="c" style="display:none">"1"</span><span data-if="cpp" style="display:none">"1"</span><span data-if="com" style="display:none">"1"</span><span data-if="dotnet" style="display:none">"1"</span><span data-if="python" style="display:none">"1"</span>, <span data-if="hdevelop" style="display:inline">'2'</span><span data-if="c" style="display:none">"2"</span><span data-if="cpp" style="display:none">"2"</span><span data-if="com" style="display:none">"2"</span><span data-if="dotnet" style="display:none">"2"</span><span data-if="python" style="display:none">"2"</span>, <span data-if="hdevelop" style="display:inline">'3'</span><span data-if="c" style="display:none">"3"</span><span data-if="cpp" style="display:none">"3"</span><span data-if="com" style="display:none">"3"</span><span data-if="dotnet" style="display:none">"3"</span><span data-if="python" style="display:none">"3"</span>, <span data-if="hdevelop" style="display:inline">'default'</span><span data-if="c" style="display:none">"default"</span><span data-if="cpp" style="display:none">"default"</span><span data-if="com" style="display:none">"default"</span><span data-if="dotnet" style="display:none">"default"</span><span data-if="python" style="display:none">"default"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Port" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Port</span><span data-if="c" style="display:none">Port</span><span data-if="cpp" style="display:none">Port</span><span data-if="com" style="display:none">Port</span><span data-if="dotnet" style="display:none">port</span><span data-if="python" style="display:none">port</span></code></b> (input_control)  </span><span>integer(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Port the image acquisition device is connected to
(<i>-1</i>: device-specific default value).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>-1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="LineIn" class="parname"><b><code><span data-if="hdevelop" style="display:inline">LineIn</span><span data-if="c" style="display:none">LineIn</span><span data-if="cpp" style="display:none">LineIn</span><span data-if="com" style="display:none">LineIn</span><span data-if="dotnet" style="display:none">lineIn</span><span data-if="python" style="display:none">line_in</span></code></b> (input_control)  </span><span>integer(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Camera input line of multiplexer
(<i>-1</i>: device-specific default value).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>-1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1, 2, 3, 4, -1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="AcqHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">AcqHandle</span><span data-if="c" style="display:none">AcqHandle</span><span data-if="cpp" style="display:none">AcqHandle</span><span data-if="com" style="display:none">AcqHandle</span><span data-if="dotnet" style="display:none">acqHandle</span><span data-if="python" style="display:none">acq_handle</span></code></b> (output_control)  </span><span>framegrabber <code>→</code> <span data-if="dotnet" style="display:none"><a href="HFramegrabber.html">HFramegrabber</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the opened image acquisition device.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Open image acquisition device using the default settings, see
* documentation of the actually used interface for more details
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',-1,-1,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)
</pre>
<h2 id="sec_result">结果</h2>
<p>If the parameter values are correct and the desired image acquisition
device could be opened, <code><span data-if="hdevelop" style="display:inline">open_framegrabber</span><span data-if="c" style="display:none">open_framegrabber</span><span data-if="cpp" style="display:none">OpenFramegrabber</span><span data-if="com" style="display:none">OpenFramegrabber</span><span data-if="dotnet" style="display:none">OpenFramegrabber</span><span data-if="python" style="display:none">open_framegrabber</span></code> 返回值
<TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  Otherwise an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="info_framegrabber.html"><span data-if="hdevelop" style="display:inline">info_framegrabber</span><span data-if="c" style="display:none">info_framegrabber</span><span data-if="cpp" style="display:none">InfoFramegrabber</span><span data-if="com" style="display:none">InfoFramegrabber</span><span data-if="dotnet" style="display:none">InfoFramegrabber</span><span data-if="python" style="display:none">info_framegrabber</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="grab_image.html"><span data-if="hdevelop" style="display:inline">grab_image</span><span data-if="c" style="display:none">grab_image</span><span data-if="cpp" style="display:none">GrabImage</span><span data-if="com" style="display:none">GrabImage</span><span data-if="dotnet" style="display:none">GrabImage</span><span data-if="python" style="display:none">grab_image</span></a></code>, 
<code><a href="grab_data.html"><span data-if="hdevelop" style="display:inline">grab_data</span><span data-if="c" style="display:none">grab_data</span><span data-if="cpp" style="display:none">GrabData</span><span data-if="com" style="display:none">GrabData</span><span data-if="dotnet" style="display:none">GrabData</span><span data-if="python" style="display:none">grab_data</span></a></code>, 
<code><a href="grab_image_start.html"><span data-if="hdevelop" style="display:inline">grab_image_start</span><span data-if="c" style="display:none">grab_image_start</span><span data-if="cpp" style="display:none">GrabImageStart</span><span data-if="com" style="display:none">GrabImageStart</span><span data-if="dotnet" style="display:none">GrabImageStart</span><span data-if="python" style="display:none">grab_image_start</span></a></code>, 
<code><a href="grab_image_async.html"><span data-if="hdevelop" style="display:inline">grab_image_async</span><span data-if="c" style="display:none">grab_image_async</span><span data-if="cpp" style="display:none">GrabImageAsync</span><span data-if="com" style="display:none">GrabImageAsync</span><span data-if="dotnet" style="display:none">GrabImageAsync</span><span data-if="python" style="display:none">grab_image_async</span></a></code>, 
<code><a href="grab_data_async.html"><span data-if="hdevelop" style="display:inline">grab_data_async</span><span data-if="c" style="display:none">grab_data_async</span><span data-if="cpp" style="display:none">GrabDataAsync</span><span data-if="com" style="display:none">GrabDataAsync</span><span data-if="dotnet" style="display:none">GrabDataAsync</span><span data-if="python" style="display:none">grab_data_async</span></a></code>, 
<code><a href="set_framegrabber_param.html"><span data-if="hdevelop" style="display:inline">set_framegrabber_param</span><span data-if="c" style="display:none">set_framegrabber_param</span><span data-if="cpp" style="display:none">SetFramegrabberParam</span><span data-if="com" style="display:none">SetFramegrabberParam</span><span data-if="dotnet" style="display:none">SetFramegrabberParam</span><span data-if="python" style="display:none">set_framegrabber_param</span></a></code>, 
<code><a href="set_framegrabber_callback.html"><span data-if="hdevelop" style="display:inline">set_framegrabber_callback</span><span data-if="c" style="display:none">set_framegrabber_callback</span><span data-if="cpp" style="display:none">SetFramegrabberCallback</span><span data-if="com" style="display:none">SetFramegrabberCallback</span><span data-if="dotnet" style="display:none">SetFramegrabberCallback</span><span data-if="python" style="display:none">set_framegrabber_callback</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="info_framegrabber.html"><span data-if="hdevelop" style="display:inline">info_framegrabber</span><span data-if="c" style="display:none">info_framegrabber</span><span data-if="cpp" style="display:none">InfoFramegrabber</span><span data-if="com" style="display:none">InfoFramegrabber</span><span data-if="dotnet" style="display:none">InfoFramegrabber</span><span data-if="python" style="display:none">info_framegrabber</span></a></code>, 
<code><a href="close_framegrabber.html"><span data-if="hdevelop" style="display:inline">close_framegrabber</span><span data-if="c" style="display:none">close_framegrabber</span><span data-if="cpp" style="display:none">CloseFramegrabber</span><span data-if="com" style="display:none">CloseFramegrabber</span><span data-if="dotnet" style="display:none">CloseFramegrabber</span><span data-if="python" style="display:none">close_framegrabber</span></a></code>, 
<code><a href="grab_image.html"><span data-if="hdevelop" style="display:inline">grab_image</span><span data-if="c" style="display:none">grab_image</span><span data-if="cpp" style="display:none">GrabImage</span><span data-if="com" style="display:none">GrabImage</span><span data-if="dotnet" style="display:none">GrabImage</span><span data-if="python" style="display:none">grab_image</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
